home *** CD-ROM | disk | FTP | other *** search
/ The CICA Windows Explosion! / The CICA Windows Explosion! - Disc 1.iso / util / c_inst24.zip / INSTALL.TXT < prev    next >
Text File  |  1994-10-25  |  29KB  |  745 lines
  1.  
  2.            CHIEF'S GENERIC INSTALL for WINDOWS v2.40
  3.            -----------------------------------------
  4.  
  5.            (c) 1994, Dr. Abimbola A. Olowofoyeku (The African Chief)
  6.            ----------------------------------------------------------
  7.  
  8.  
  9.     Files in the package
  10.     --------------------
  11.     1. INSTALL.EXE    (Windows install executable)
  12.     2. WINSTALL.HLP   (basic help file for the installer)
  13.     3. SETUP.EXE      (OPTIONAL small loader for INSTALL.EXE)
  14.     4. SAMPLExx.INF   (sample INF files for WINSTALL.INF)
  15.     5. INSTALL.TXT    (this file)
  16.  
  17.  
  18.     What is CHIEF'S GENERIC INSTALL?
  19.     --------------------------------
  20.     Chief's Generic Install (hereinafter referred to as "Install") is a
  21.     generic program for installation of Windows applications.
  22.  
  23.     Install is an "off-the-shelf" installation suite. The program will
  24.     copy files from floppy disks (or a directory on a hard disk) to the
  25.     destination directory. If the files are compressed with Microsoft's
  26.     COMPRESS.EXE they will be decompressed automatically.In this respect
  27.     Install uses the routines in LZEXPAND.DLL. If the files are not
  28.     compressed, they will simply be copied.
  29.  
  30.     -----
  31.     NOTE:
  32.     -----
  33.     The main executable is INSTALL.EXE - and that is all that needs to
  34.     be run. I have supplied SETUP.EXE as an optional loader. All it does
  35.     is to;
  36.  
  37.      [a] display a "initializing install ..." message
  38.      [b] copy the necessary Install files (INSTALL.EXE, WINSTALL.INF,
  39.          WINSTALL.HLP) to the TEMP directory.
  40.          For these purposes, these 3 files may be compressed on the
  41.          install disks - but they must retain their real names (as
  42.          above) - except INSTALL.EXE, which if compressed with the -r
  43.          option, can be called "INSTALL.EX_" (the original name will
  44.          be restored by SETUP.EXE)
  45.      [c] load the copy of INSTALL.EXE from the TEMP directory, with the
  46.          parameters necessary for it to work properly if run in this
  47.          way
  48.  
  49.  
  50.     Is this useful? "Not really" is the answer. It may help to speed up
  51.     loading if the user is using a slow floppy disk (or if INSTALL.EXE gets
  52.     bigger than it is now) - but at the moment, it does not really speed up
  53.     things. It may help in cases where there are many floppy disks, and
  54.     system memory is low (in case Windows needs to read some parts of
  55.     INSTALL.EXE again from disk). This will rarely (if ever) occur -
  56.     because the code segment in INSTALL.EXE is PERMANENT (not discardable).
  57.  
  58.     So - SETUP.EXE is here only for future purposes - and for people who
  59.     prefer to type "A:SETUP" instead of "A:INSTALL".
  60.  
  61.  
  62.     ---------------------
  63.     ---------------------
  64.     Using Chief's Install
  65.     ---------------------
  66.     ---------------------
  67.     I have tried to make Install as easy to use as possible. You only
  68.     need to take the following steps;
  69.  
  70.       1. Create your installation disk set by placing your application's
  71.          files on them (up to 20 installation disks are supported).
  72.  
  73.      2.  You may or may not compress the files with COMPRESS.EXE (it is
  74.          immaterial whether you do so or not). If files are compressed
  75.          and an underscore is used in the compressed file names, these
  76.          names will only be converted to the original file names if
  77.          they were compressed with the -r option.
  78.  
  79.  
  80.       3. Create an installation information file in ASCII format, using a
  81.          text editor. The file should be called WINSTALL.INF, and should be
  82.          in the format described below.
  83.  
  84.       4. Run the Install program.
  85.  
  86.     That's it folks!
  87.  
  88.  
  89.     Restrictions/Features
  90.     ---------------------
  91.     1. You can only install into any combination of the following;
  92.          (a) ONE destination directory, and up to 20 subdirectories
  93.              under it
  94.          (b) the Windows directory
  95.          (c) the Windows SYSTEM directory
  96.          (d) the TEMP directory
  97.     2. Only a maximum of 20 installation disks are supported. Install will
  98.        prompt for the disks as they are required.
  99.     3. Install will optionally offer to put the destination directory
  100.        into the "PATH" statement in AUTOEXEC.BAT
  101.     4. Install will optionally create a Program Manager group file, and
  102.        icons for any supplied file(s) - .EXEs, README files, etc.
  103.     5. Install will optionally run any supplied program(s) during the
  104.        installation, as part of the installation process.
  105.     6. Install will optionally run any supplied program(s) immediately after
  106.        the installation is complete
  107.     7. The stipulated format of the WINSTALL.INF file must be followed
  108.        strictly.
  109.     8. Install allows you to supply on-line for the installation.
  110.        You have to create a Windows help file called WINSTALL.HLP. This
  111.        help file can be accessed by clicking on the "HELP" button. A simple
  112.        one is supplied. You can either use that, or create your own.
  113.        If no WINSTALL.HLP file is found in the path, then the "HELP"
  114.        button is removed from the Install window.
  115.     9. Install will check whether there is sufficient space on the target
  116.        drive - based on information which you supply as to how much disk
  117.        space your application requires.
  118.        If you need extra temporary disk space for the installation, Install
  119.        can check for this also.
  120.    10. Install will make entries in any INI (or other) file(s) specified
  121.        by you. Up to 20 entries can be made. Do NOT use this feature to
  122.        insert an entry which may already exist - the old entry will be
  123.        deleted and replaced by the new one (e.g., do NOT use it for
  124.        "DEVICE=" lines in SYSTEM.INI
  125.  
  126.  
  127.     The format of WINSTALL.INF
  128.     --------------------------
  129.     WINSTALL.INF is the configuration file for the installation. You need
  130.     to follow the instructions on this file carefully, otherwise, Install
  131.     will not work correctly. The best thing is to edit the sample files
  132.     which I have provided. They contain sufficient comments for you to
  133.     understand them. WINSTALL.INF is a standard ASCII file, in the
  134.     following format;
  135.  
  136.     1. Any line beginning with a ";", or "[" or "REM" is ignored
  137.     2. Empty lines are ignored
  138.  
  139.           e.g., these lines will be ignored
  140.  
  141.               [This line will be ignored]
  142.               ; So will this line
  143.  
  144.               REM  so will the one just above me, and me as well!
  145.  
  146.  
  147.     3. Each line must not contain more than 220 characters
  148.  
  149.     4. There are RESERVED WORDS for each valid entry - as follows;
  150.                  --------------
  151.           $TITLE      : your program's title
  152.           $TARGET     : the default target directory
  153.           $SPACE      : the amount disk space needed for the install
  154.           $SWAP-SPACE : any temporary swap space needed for the install
  155.           $DISK       : 1-20 = the installation disks and their contents
  156.           $DEST       : points to the target directory chosen by the user
  157.           $WINDIR     : points to the Windows directory
  158.           $SYSDIR     : points to the Windows SYSTEM directory
  159.           $TEMPDIR    : points to the TEMP directory
  160.           $INI        : text file(s) to write entries into
  161.           $GROUP      : title of the Program Manager group
  162.           $ICON       : file(s) to create Program Manager icons for
  163.           $PRE-EXEC   : program(s) to run DURING the installation
  164.           $EXEC       : program(s) to run AFTER the installation
  165.           $CLEANUP    : file(s) to be deleted AFTER the installation
  166.           $WINDOW     : whether INSTALL should start MAXIMIZEd or not
  167.           $WINDOW-BACKGROUND : to change the background color of the window
  168.           $TEXT-BACKGROUND : to change the background color of the text
  169.           $SETCHECKBOX   : to automatically set the checkbox for creation
  170.                            of Program Manager group
  171.           $NO-END-DIALOG : to disable the final "installation completed" dialog.
  172.           $NO-PATH-DIALOG: to disable dialog to update AUTOEXEC.BAT
  173.  
  174.  
  175.     RESERVED WORD
  176.     *************
  177.  
  178.     $DISK
  179.     -----
  180.     You use this reserved word to specify the disk(s) in the installation
  181.     set, and the file(s) which should be copied from them. Each file name
  182.     or file specification should be separated from the next one by a
  183.     semi-colon.
  184.  
  185.     You can use the wildcard character "*" in this regard. The format for
  186.     specifying the disk(s) is this;
  187.  
  188.          $DISK n = <filenames(s)>
  189.  
  190.             where:
  191.              n = numbers from 1 to 20
  192.              <filename(s)> = the file specifications
  193.              the easiest thing to do would be to just specify "*.*" - to
  194.              copy all the files - but you can be more specific
  195.  
  196.         EXAMPLES:
  197.           $DISK 1 = *.*
  198.           $DISK 2 = *.DLL;*.HLP;*.DRV;WS*.*;EXPAND.EXE;COMPRESS.EXE;README.TXT
  199.           $DISK 3 = HELP.DOC;*.FFF
  200.  
  201.  
  202.        * If you specify a file that does not exist on the disk, it will just
  203.          be ignored.
  204.  
  205.        * A maximum of 30 file specifications is allowed on each "$disk" line -
  206.          but note that each line cannot be longer than 220 characters in total.
  207.  
  208.        * Compressed files with underscores in the filename will have the
  209.          filenames expanded into the name of the original files only if
  210.          the original files were compressed with the -r option
  211.  
  212.        * NOTE: *
  213.        ---------
  214.        * It is advisable (but not necessary) to use underscores in compressed
  215.          file names. This is only for the (cosmetic) purpose of enabling Install
  216.          to differentiate between compressed and uncompressed files when
  217.          displaying date and size of existing files concerning which the user
  218.          is being prompted for over-write permission.
  219.  
  220.          If a compressed file can be identified in this way, Install will not
  221.          display the size of the compressed file in such cases, since it might
  222.          confuse the user. If the compressed file name is the same as that of
  223.          the original file, then Install cannot make this type of distinction.
  224.  
  225.  
  226.  
  227.     RESERVED WORD
  228.     *************
  229.  
  230.     $TITLE
  231.     ------
  232.     This us used to specify the name or title of your application. This is
  233.     what will appear in the title of the installation program's window -
  234.     You can have only ONE such line.
  235.     - e.g.;
  236.             $TITLE=Great Program v1.20
  237.  
  238.  
  239.     RESERVED WORD
  240.     *************
  241.  
  242.     $SPACE
  243.     ------
  244.     Use this to specify the amount of disk space needed for the installation.
  245.     The amount should be in BYTES and should only contain whole numbers (no
  246.     spaces, no letters, and no decimals).
  247.  
  248.     This information is used by Install to warn the users of the amount
  249.     of space that they need to have free on their disks, and to show the
  250.     progress of the installation in the "percentage meter". Install will
  251.     check to see that the specified amount of space exists on the
  252.     target drive before installation begins. If there is insufficient
  253.     space, Install will abort with an error message.
  254.  
  255.     There is no need for the number to correspond exactly with the actual
  256.     required number of bytes - a difference of up to 2% of the size of
  257.     your application (plus or minus) is allowed, and such differences will
  258.     be catered for automatically. In fact, it is always good to add about
  259.     1% to the actual disk space needed - because of the vagaries of disk
  260.     cluster sizes, it may be wise to over-estimate the disk space needed
  261.     (a little bit of trial and error is in order here).
  262.     You can have only ONE such line.
  263.  
  264.     e.g.,
  265.  
  266.          $SPACE=2002003
  267.  
  268.  
  269.     $SWAP-SPACE
  270.     -----------
  271.     Use this to specify the amount of any temporary swap disk space
  272.     needed for the installation. The amount should be in BYTES and
  273.     should only contain whole numbers (no spaces, no letters, and
  274.     no decimals).
  275.  
  276.     This information is used by Install to warn the users of the amount
  277.     of space that they need to have free on their disks - bit it does not
  278.     show in the "percentage meter".
  279.  
  280.     You can have only ONE such line.
  281.  
  282.     e.g.,
  283.  
  284.          $SWAP-SPACE=0
  285.  
  286.  
  287.     RESERVED WORD
  288.     *************
  289.  
  290.     $TARGET
  291.     -------
  292.     This is used to specify the name of the DEFAULT target directory for the
  293.     installation. The user will be able to change this at run time.
  294.      - e.g.,
  295.             $TARGET=C:\MYPROGRAM
  296.  
  297.      If the target directory does not exist Install will create it - but
  298.      note that it will not create directories recursively.
  299.      You can have only ONE such line.
  300.  
  301.  
  302.      Other Directories
  303.      -----------------
  304.      By default, ALL the files will be installed into whatever is the target
  305.      directory chosen by the user. You can however specify that certain files
  306.      should be installed into subdirectories UNDER THE TARGET DIRECTORY TREE,
  307.      or into the WINDOWS DIRECTORY, or into the WINDOWS SYSTEM DIRETORY, or
  308.      into the TEMP DIRECTORY.
  309.  
  310.      To use this, you use the $DEST, $WINDIR, $SYSDIR, $TEMPDIR reserved words.
  311.  
  312.     RESERVED WORD
  313.     *************
  314.  
  315.      $DEST
  316.      -----
  317.      [i] Where ever this appears at the beginning of a line, the following take place;
  318.           (a) "$DEST" is replaced with the target directory selected by the
  319.               user. For example, entry of "$DEST\BIN=PROG.EXE", if the user
  320.               installed to "C:\NEWPROG", becomes "C:\NEWPROG\BIN=PROG.EXE"
  321.           (b) anything after the "=" sign is taken as the file(s) to be installed into
  322.               that directory (instead of into the target directory). There can be up to
  323.               14 file names, each separated by a semi-colon (NO wildcards are allowed
  324.               here!).
  325.  
  326.      The sub directories will be created when necessary - but note that the order in which
  327.      they are specified may be important - if there are deep levels of nesting, the ones
  328.      higher up the tree must be specified first.
  329.  
  330.      You can have up to 20 such lines.
  331.  
  332.      [ii]  Where ever this appears elsewhere in a line, the "$DEST" is replaced with
  333.            the target directory selected by the user. This use of the $DEST reserved
  334.            word is only useful in the "$ICON", "$INI", and "$EXEC" lines.
  335.  
  336.  
  337.     RESERVED WORD
  338.     *************
  339.  
  340.      $WINDIR
  341.      -------
  342.        [i] Whenever this appears at the beginning of a line, the files on that line are
  343.            installed to the Windows directory (instead of the target directory).
  344.            There can be up to 14 file names, each separated by a semi-colon (no wildcards
  345.            are allowed here).
  346.        You can have only ONE such line.
  347.  
  348.        [ii] Where ever this appears elsewhere in a line, the "$WINDIR" is replaced with
  349.            the Windows directory. This use of the $WINDIR reserved word is only useful in
  350.            the "$ICON", "$INI", and "$EXEC" lines.
  351.  
  352.  
  353.     RESERVED WORD
  354.     *************
  355.  
  356.      $SYSDIR
  357.      -------
  358.        [i] Whenever this appears at the beginning of a line, the files on that line are
  359.            installed to the Windows SYSTEM directory (instead of the target directory).
  360.            There can be up to 14 file names, each separated by a semi-colon (no wildcards
  361.            are allowed here).
  362.        You can have only ONE such line.
  363.  
  364.        [ii] Where ever this appears elsewhere in a line, the "$SYSDIR" is replaced with
  365.            the Windows SYSTEM directory. This use of the $SYSDIR reserved word is only
  366.            useful in the "$ICON", and "$EXEC" lines.
  367.  
  368.  
  369.     RESERVED WORD
  370.     *************
  371.  
  372.      $TEMPDIR
  373.      --------
  374.        [i] Whenever this appears at the beginning of a line, the files on that line are
  375.            installed to the TEMP directory (instead of the target directory).
  376.            There can be up to 14 file names, each separated by a semi-colon (no wildcards
  377.            are allowed here).
  378.        You can have only ONE such line.
  379.  
  380.        [ii] Where ever this appears elsewhere in a line, the "$TEMPDIR" is replaced with
  381.            the TEMP directory. This use of the $TEMPDIR reserved word is only useful in
  382.            the "$INI", and "$EXEC" lines.
  383.  
  384.  
  385.     RESERVED WORD
  386.     *************
  387.  
  388.     $INI
  389.     ----
  390.     This is used to specify any ASCII files that configuration information
  391.     should be written into. Normally, these will be INI files of some sort,
  392.     but they can be any file, as long as it is in ASCII format.
  393.  
  394.     You have have up to 20 "$INI" lines - and each line MUST be in the format
  395.     prescribed below;
  396.        * each line must contain 4 entries - each separated with a semi-colon
  397.  
  398.        [a] the first entry is the NAME of the file to be written to - a full
  399.            path must be supplied - otherwise, the file is presumed to be in
  400.            the WINDOWS directory. You can use "$DEST" here, to specify files
  401.            in the directory tree of the target directory.
  402.            If the file does not exist, it is created.
  403.        [b] the second entry is the title of the section ("Application name"
  404.            in Windows API speak) that should contain the entry.
  405.        [c] the third entry is the name of the entry you wish to make ("Keyname"
  406.            in Windows API speak)
  407.        [d] the fourth entry is the string that you wish to associate with the
  408.            entry.
  409.  
  410.      - e.g.,
  411.           $INI=C:\AUTOEXEC.BAT;MYPROG;SET PROGDIR;$DEST
  412.           $INI=$DEST\MYPROG.INI;CONFIG;STARTUP;PROG.EXE /FE=XDS.XCL
  413.           $INI=WIN.INI;EXTENSIONS;GFD;$DEST\BIN\GFD2.EXE ^.GFD
  414.  
  415.  
  416.     RESERVED WORD
  417.     *************
  418.  
  419.     $GROUP
  420.     ------
  421.     This is used to specify the name of the Program Manager Group
  422.     in which the icons will be created. This can be the name of an
  423.     existing group (e.g., "Accessories", "Main", etc.) in which case,
  424.     the items will just be added to the ones already in that group.
  425.  
  426.     However, you may specify a completely new group. If this does not
  427.     exist, it will be created (e.g., "MyProgram").
  428.     You can have only ONE such line.
  429.  
  430.  
  431.     RESERVED WORD
  432.     *************
  433.  
  434.     $ICON
  435.     -----
  436.     This is used to specify the names of the files for which you want
  437.     Program Manager icons to be created. There can be a maximum of 12 icons.
  438.  
  439.     Each $ICON line should contain only ONE entry. This is the name of the
  440.     file to create an icon for (this could be a program file plus a
  441.     parameter or any other file). This should be followed by a semi-colon,
  442.     and after the semi-colon, the title that Program Manager should give to
  443.     the icon.
  444.  
  445.     Each name should be separated by a semi-colon. You can put them all
  446.     one one "$ICON" line - or you can have up to 12 "$ICON" lines.
  447.  
  448.           e.g.,
  449.           $ICON=MYMAIN.EXE;Cool Prog v1.20
  450.           $ICON=WINHELP.EXE MYPROG.HLP;My help file
  451.           $ICON=NOTEPAD.EXE ORDER.FRM;Order Form
  452.           $ICON=NOTEPAD.EXE REGISTER.TXT;Registration documentation
  453.           $ICON=NOTEPAD.EXE README.TXT;Readme file
  454.  
  455.  
  456.     RESERVED WORD
  457.     *************
  458.  
  459.    $EXEC
  460.    -----
  461.    This line is optional. It specifies the name(s) of any program(s) that
  462.    should be run immediately after the installation is completed (with any
  463.    optional parameters to be passed to the programs). You can have only ONE
  464.    such line.
  465.  
  466.     - e..g.,
  467.  
  468.         $EXEC=CONFIG.EXE
  469.  
  470.     You can put as many as 5 programs on this line. In such cases, each
  471.     one must be terminated by a semi-colon
  472.  
  473.     - e.g.,
  474.  
  475.         $EXEC=CONFIG.EXE /DIR=C:\TEMP; MYPROG1.EXE; MYPROG2.EXE /NEW
  476.  
  477.        In the above example, there are 3 programs to be run. The first
  478.        and the third are run with parameters, while the second one has no
  479.        parameter.
  480.  
  481.  
  482.    $PRE-EXEC
  483.    ---------
  484.    This line is optional. It specifies the name(s) of any program(s) that
  485.    should be run during the installation, as part of the installation
  486.    process. These programs will be run immediately after the files have
  487.    been copied from the disks. Install will try to wait for these programs
  488.    to terminate, before continuing. Such attempted waiting will work for
  489.    Windows programs, but will fail if used to run DOS programs under OS/2.
  490.  
  491.     - e..g.,
  492.  
  493.         $PRE-EXEC=EXPAND.EXE $DEST\REE.BIN
  494.  
  495.  
  496.    $CLEANUP
  497.    -------
  498.    This is optional. It specifies the name(s) of any temporary files(s)
  499.    that should be deleted after the installation. Such deletions (if any)
  500.    will be done immediately after any $PRE-EXEC lines have executed
  501.    and returned. If there is no $PRE-EXEC line, then the deletions will
  502.    be done after the $INI lines have been processed. If there are no
  503.    $INI lines, then the deletions will be immediatelt after the $DISK
  504.    lines have been processed.
  505.  
  506.    If the specified files do not exist, they are simply ignored.
  507.  
  508.    There can be up to 20 $CLEANUP lines. Each line should contain only
  509.    ONE entry. The only other reserved words permissible on these lines
  510.    are $DEST and $TEMPDIR. I will *never* add $WINDIR or $SYSDIR to this
  511.    list, because I can see no reason why one would want to delete files
  512.    from people's Windows or SYSTEM directories.
  513.  
  514.    Use this reserved word with care. I accept no responsibility for any
  515.    problems caused by using it.
  516.  
  517.     - e..g.,
  518.  
  519.     $CLEANUP=$TEMPDIR\4EDE6.$$$
  520.     $CLEANUP=$TEMPDIR\54DE6.$$$
  521.     $CLEANUP=$DEST\TEMPFIL.INI
  522.  
  523.  
  524.    The $TEMPDIR can be used here with the Install program files in cases
  525.    where you choose to use SETUP.EXE as a loader - e.g.,
  526.  
  527.     $CLEANUP=$TEMPDIR\INSTALL.EXE
  528.     $CLEANUP=$TEMPDIR\WINSTALL.INF
  529.     $CLEANUP=$TEMPDIR\WINSTALL.HLP
  530.  
  531.    This way, Install can cleanup the files which have been copied by
  532.    SETUP.EXE to the TEMP directory.
  533.  
  534.  
  535.     RESERVED WORD
  536.     *************
  537.  
  538.    $WINDOW
  539.    -------
  540.    This line is optional. It should specify whether you want Install to
  541.    start up maximized or not. If the entry here is "MAXIMIZE" then Install
  542.    will start maximized - otherwise it will just start normally.
  543.    You can have only ONE such line.
  544.  
  545.  
  546.    RESERVED WORD
  547.    *************
  548.  
  549.    $NO-END-DIALOG
  550.    --------------
  551.    This line is optional, and is not very useful. All it does is to
  552.    suppress the final dialogs which inform the user about whether the
  553.    installation was successful or not, and that the installation is
  554.    completed. The default behaviour of Install is to present these
  555.    dialogs to the user. Use this reserved word to disable that feature.
  556.    If this feature is used, the warning dialog that comes up if the size
  557.    of the files actually installed is less than 98% of the size stated in
  558.    the $SPACE reserved word is also disabled.
  559.    This line takes no parameter.
  560.  
  561.  
  562.    RESERVED WORD
  563.    *************
  564.  
  565.    $NO-PATH-DIALOG
  566.    ---------------
  567.    This line is optional. It disables the dialog box which asks the
  568.    user whether the target directory should be added to the PATH
  569.    statement in AUTOEXEC.BAT. The default behaviour is to present this
  570.    dialog. Use this reserved word to disable that feature.
  571.    This line takes no parameter.
  572.  
  573.  
  574.    RESERVED WORD
  575.    *************
  576.  
  577.    $SETCHECKBOX
  578.    ------------
  579.    This line is optional. It automatically checks the checkbox titled
  580.    "click here to create Program Manager item".
  581.    This line takes no parameter.
  582.  
  583.  
  584.  
  585.    RESERVED WORD
  586.    *************
  587.  
  588.    $WINDOW-BACKGROUND
  589.    ------------------
  590.    This line is optional. It can be used to set the background color
  591.    of the main window of the Installer. The default is to have a white
  592.    background. Because the background is a Windows brush handle, the
  593.    only valid values for this setting are 0,1,2,3, or 4
  594.        0 = White
  595.        1 = Light Grey
  596.        2 = Grey
  597.        3 = Dark Grey
  598.        4 = Black
  599.  
  600.    If you use this to change the window background, be sure to also set
  601.    the $TEXT-BACKGROUND (below) to an appropriate setting. For example,
  602.    if this setting is 1 (light grey) then the text background should be
  603.    set to 192,192,192 (so that the window and text backgrounds should
  604.    match).
  605.  
  606.    e.g.,
  607.  
  608.    $WINDOW-BACKGROUND=1
  609.    $TEXT-BACKGROUND=192,192,192
  610.  
  611.    $WINDOW-BACKGROUND=2
  612.    $TEXT-BACKGROUND=128,128,128
  613.  
  614.  
  615.  
  616.    RESERVED WORD
  617.    *************
  618.  
  619.    $TEXT-BACKGROUND
  620.    ----------------
  621.    This line is optional. It can be used to set the background color
  622.    of the text in the main window of the Installer. The default is to
  623.    have a white background.
  624.  
  625.    The color used here can either be;
  626.      [a] one long integer value (you can use hexadecimal values in
  627.          Pascal notation) - see below for explanation
  628.      or
  629.      [b] three values represent RGB (red, green, blue) values.
  630.  
  631.    If using RGB values, they should be separated by commas, or
  632.    semi-colons (e.g:  128,128,128 - for a dark gray background)
  633.  
  634.    If using a hexadecimal value (those that begin with $00 and then
  635.    are followed by SIX values). The SIX values here represent
  636.    Blue, Green, Red - or reversed RGB. In this respect, "FF" turns the
  637.    color to full intensity, "00" turns it off, and any other value
  638.    varies the intensity.
  639.  
  640.    Note that the color that results from any value depends on the
  641.    display driver of the user (particularly the number of colors).
  642.    For a 256 color setup, you can use the following values;
  643.  
  644.           White       : $00FFFFFF
  645.           White       : 255,255,255
  646.  
  647.           Black       : $00000000
  648.           Black       : 0,0,0
  649.  
  650.           DarkGray    : $00808080
  651.           DarkGray    : 128,128,128
  652.  
  653.           Red         : $000000FF
  654.           Red         : $255,0,0
  655.  
  656.           Blue        : $00FF0000
  657.           Blue        : 0,0,255
  658.  
  659.           DarkRed     : 128,0,0
  660.           DarkRed     : $00000080
  661.  
  662.           DarkPurple  : 128,128,240
  663.           DarkBlue    : 0,0,150
  664.           Purple      : 200,0,200
  665.           Light Cyan  : $00FFFF00
  666.           Green       : $0000FF00
  667.           Yellow      : $0000FFFF
  668.           Magena      : $00FF00FF
  669.           LighGray    : $006F9FFF
  670.           Gray        : $006688FF
  671.  
  672.  
  673.     e.g.,
  674.          $TEXT-BACKGROUND=128,128,128
  675.          $TEXT-BACKGROUND=$00FFFFFF
  676.  
  677. //////////////////////////////////////////////
  678.  
  679.     LICENSE
  680.     -------
  681.  
  682.     Chief's Install is released as "ChiefWare". This means that you may use
  683.     and supply it as the installation routine for any of your applications,
  684.     as long as;
  685.        [1] You offer me, by e-mail, a (registered) copy of your application,
  686.            and, if I am interested in it, you send me a free copy. This point
  687.            only applies to shareware and freeware applications
  688.  
  689.        OR, if your application is a commercial one,
  690.            You send me a nice and unique postcard from your area
  691.  
  692.        [2] My name does NOT appear ANYWHERE in your application's
  693.            documentation - I am not interested in answering any questions
  694.            from any of your customers.
  695.  
  696.     You may also distribute it freely - as long as;
  697.        [1] ALL the files which I have supplied are included, and
  698.        [2] NO ATTEMPT is made to modify or alter ANYTHING in any of the files.
  699.        [3] You do not charge ANYTHING for distributing this package (disk
  700.            vendors may charge a reasonable fee, not exceeding $5 (US) for
  701.            media and duplication).
  702.  
  703.  
  704.     Please note the disclaimers below.
  705.  
  706.     DISCLAIMER
  707.     ----------
  708.     I do NOT warantee ANYTHING concerning any of the programs which
  709.     make up Chief's Install. I accept NO RESPONSIBILITY for ANY LOSS
  710.     OR DAMAGE of ANY kind, including, but not limited to, losses of a
  711.     physical, mental, social, financial, marital, or of whatever nature,
  712.     resulting from the use, or the purported use of Chief's Install,
  713.     for any purpose whatsoever. You use Chief's Install ENTIRELY AT YOUR
  714.     OWN RISK, and you supply it to your customers or acquaintances
  715.     ENTIRELY AT YOUR OWN RISK.
  716.  
  717.     If these terms are not acceptable to you, then please DELETE all
  718.     the files from your disks immediately.
  719.  
  720.  
  721.     BUGS
  722.     ----
  723.     There may be bugs in the program, although I do not know of any extant.
  724.     I welcome bug reports. I will try to fix them if I can. If I can not
  725.     fix them, then sorry.
  726.  
  727.  
  728.     Contact address:
  729.     ----------------
  730.     Dr. Abimbola Olowofoyeku
  731.     268 Horwood
  732.     Newcastle
  733.     Staffs, ST5 5BQ
  734.     ENGLAND
  735.  
  736.     Email: laa12@keele.ac.uk
  737.  
  738.  
  739.  
  740.       ------------------
  741.       Dr. A. Olowofoyeku
  742.       October 1994
  743.       ------------------
  744.  
  745.